home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr20 / plist09c.zip / PICLIST.DOC < prev    next >
Text File  |  1995-03-22  |  33KB  |  780 lines
  1.              ┌──────────────────────────────────────┐
  2.              │         PicList version 0.9c         │
  3.              ╞══════════════════════════════════════╡
  4.              │ (c) 1994/1995 CSP Udenhout, Holland  │
  5.              └──────────────────────────────────────┘
  6.  
  7.  
  8. CONTENTS :
  9.  
  10. 1. Useful information
  11.    1.1 Disclaimer of warranty
  12.    1.2 License
  13.    1.3 Terms of distribution
  14.    1.4 Acknowledgements
  15.  
  16. 2. What is PicList and what do you need to run it
  17.  
  18. 3. Why you should use PicList instead of other programs
  19.  
  20. 4. How to use PicList
  21.    4.1 Configuring PicList
  22.        4.1.1 Environment
  23.        4.1.2 Files
  24.        4.1.3 Printer
  25.    4.2 Cataloging a disk
  26.    4.3 Supported graphical formats
  27.    4.4 Viewing/editing the PicList-datafile
  28.        4.4.1 Edit datafile
  29.        4.4.2 Deleting an entry
  30.        4.4.3 Copy and Move to other datafiles
  31.        4.4.4 Changing the current datafile
  32.        4.4.5 Information about the datafile
  33.        4.4.6 Re-sort datafile on other item
  34.    4.5 Putting out the list on printer or in a file
  35.    4.6 Data Im- and Export
  36.    4.7 Viewing/editing the PicList-indexfile
  37.        4.7.1 Edit indexfile
  38.        4.7.2 Add to indexfile
  39.        4.7.3 Deleting a description
  40.        4.7.4 Copy and Move to other indexfiles
  41.        4.7.5 Changing the current indexfile
  42.        4.7.6 Information about the indexfile
  43.        4.7.7 Create wildcards
  44.        4.7.8 Re-sort indexfile on other item
  45.    4.8 Index Im- and Export
  46.    4.9 Using the viewer
  47.  
  48. 5. Known bugs
  49.  
  50. 6. What can be expected in the future (What to do)
  51.  
  52. 7. How to contact the writer
  53.  
  54. -------------------------------------------------------------------
  55.  
  56. 1.1 Disclaimer of warranty
  57.  
  58. THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS". THE AUTHOR HEREBY
  59. DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS
  60. DOCUMENTATION FILE, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  61. TO DAMAGE TO HARDWARE, SOFTWARE AND/OR DATA FROM USE OF THIS
  62. PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE TO
  63. YOU OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR USE OF THIS SOFTWARE
  64. INDICATES THAT YOU HAVE READ AND AGREE TO THESE AND OTHER TERMS
  65. INCLUDED IN THIS DOCUMENTATION FILE.
  66.  
  67. DUE TO THE NATURE OF EVOLVING PROGRAMMING AND THE VARIOUS HARDWARE
  68. AND SOFTWARE ENVIRONMENTS IN WHICH THIS SOFTWARE MAY BE USED, IT IS
  69. UNDERSTOOD THAT OCCASIONAL "BUGS" OR UNFITNESS MAY ARISE. THE USER
  70. SHOULD ALWAYS TEST THIS SOFTWARE THOROUGHLY WITH NON-CRITICAL DATA
  71. BEFORE RELYING ON IT.
  72.  
  73. 1.2 License
  74.  
  75. PicList v0.9c is shareware. This means that after a trial period
  76. of 30 days, you'll have to pay in order to use this program.
  77.  
  78. THIS PROGRAM IS IN NO WAY 'CRIPPLED' OR 'STRIPPED'; IT IS THE
  79. COMPLETE PACKAGE.
  80.  
  81. If you want to register your copy of PicList, please contact me
  82. at the InterNet E-mail address : ericg@stack.urc.tue.nl. The
  83. registration fee for PicList is DFL 30, DM 30 or $19.
  84. Once you've registered PicList, you don't have to pay again for
  85. upgrades. Each new version that is released will be compatible
  86. with your key. If for some reason I decide to change the keys,
  87. you'll get a new one for free.
  88.  
  89. Because for some countries it can be expensive to transfer money
  90. to the Netherlands, I also accept it if you send me a CD. Please
  91. contact me for more info about this.
  92.  
  93. This registrationfee is for 1 user only. If you want to get a
  94. registration for more users, contact me. BBS-SysOps may use
  95. PicList to maintain their BBS, the registration fee for this
  96. kind of use is the same as for an individual user. If you want
  97. to get a sitelicense for PicList (i.e. you use PicList on more
  98. than 1 computer), please contact me.
  99.  
  100. As soon as I receive your registrationfee, I'll send you your
  101. personal registration code, with which you can register your copy
  102. of PicList. Every registered user that has an InterNet E-mail
  103. address will also receive information about updates.
  104.  
  105. 1.3 Terms of distribution
  106.  
  107. Redistribution of PicList v0.9c must include the software, its
  108. documentation file, order form and all supplemental files (see
  109. FILES.TXT) as a single unit without any modification AND subject to
  110. the following conditions :
  111.  
  112.   1. Any individual is welcome to make copies for his/her friends
  113.      and/or colleagues if NO FEE is charged.
  114.  
  115.   2. Electronic bulletin boards, whether they charge or do not
  116.      charge their users subscription fee, are welcome to post the
  117.      program for down loading as long as they do not charge any fee
  118.      in particular for the distribution of PicList v0.9c.
  119.  
  120.   3. Computer information services such as CompuServe (CIS), Genie,
  121.      etc., may post this software for their subscribers.
  122.  
  123.   4. Other commercial enterprises wishing to distribute PicList
  124.      v0.9c either alone or in combination with other hardware,
  125.      software, books or materials must obtain permission in writing
  126.      from the author. THIS WILL NOT BE A FREE USE OF PICLIST!
  127.  
  128. 1.4 Acknowledgements
  129.  
  130. I want to thank the following people:
  131.  
  132.       Frank Roghair : Thanks for the help with the gathering of
  133.                       information for this and other program(s)
  134.                       and for beta-testing;
  135.       Thomas Wagner : Providing the EXEC-program that I used
  136.                       within PicList;
  137.       My mother     : For providing the lots of cola I used when
  138.                       writing this program :-)
  139.  
  140. And ofcourse the beta-testers (especially Rene Traa, Robert van
  141. Halder and Hans-Jan Tolboom)
  142.  
  143. -------------------------------------------------------------------
  144.  
  145. 2. What is PicList and what do you need to run it
  146.  
  147. PicList is a handy tool (I hope) for cataloging your graphical
  148. archive. It checks a drive (Floppy or Hard-disk) for all graphical
  149. files, and saves the characteristics of them in a file, which can
  150. be edited and printed, so you can find that single picture in your
  151. big bunch of files, or you can give a list of your pictures to a
  152. friend.
  153.  
  154. Because a filename can only contain 8 characters, this name isn't
  155. always a good reference for your file, that's why PicList helps
  156. you with a description, that can take up to 25 characters, so
  157. enough to point out what the picture is about.
  158.  
  159. You need at least an 80286 IBM-compatible PC, ofcourse with the
  160. standard 1 Mb memory, and using an operating system compatible
  161. with MS-DOS 3.30 or better. A harddisk is NOT necessary, but then
  162. you need at least 2 diskdrives (1 for the PicList-disk, and 1 for
  163. the disks that must be cataloged). PicList is tested on CGA, EGA
  164. and VGA-systems, and worked perfectly (CGA doesn't use the
  165. enhanced screen layout, but that doesn't give problems).
  166.  
  167. If you don't use a harddisk, and you haven't got EMS or XMS memory
  168. available, then you'll have to be sure that your current disk has
  169. enough space to write a temporary file on. This file is used when
  170. PicList tries to access the viewer, and when PicList creates the
  171. scrollboxes for your index- or datafile.
  172.  
  173. PicList should work within a MS-Windows environment. However, I
  174. didn't wrote it for use with MS-Windows in the first place, and I
  175. haven't fully tested it. If people have experience with it, please
  176. let me know. This also concerns people who tested it in a DOS-box
  177. within OS/2, Linux or other operating systems. If you have the
  178. ability to specify the amount of memory that PicList may use (e.g.
  179. with the PIF-file in MS-Windows), you best could reserve at least
  180. 700 kB (The swap to the fileviewer uses about 650 kB).
  181.  
  182. Because PicList saves his configuration in his EXE-file, you must
  183. keep the program on a writable disk. This may either be a floppy
  184. or harddisk.
  185.  
  186. PicList can be normally used on compressed drives (i.e. drives
  187. treated with Stacker, DoubleSpace, SuperStore or equal) and can
  188. work normally when compressed with programs like PKLite, Diet or
  189. equal.
  190.  
  191. CAUTION USERS OF SCREENSAVERS:
  192.  
  193. Most screensavers restore the original ASCII-table when they
  194. become active. The original ASCII-table has been changed by
  195. PicList to provide some effects on your screen. This leads to a
  196. messed up screen when you return from your Screensaver to PicList.
  197.  
  198. This doesn't result in any damage of your copy of PicList or other
  199. stuff, and it doesn't have any effect on the current session.
  200. The screen will be rebuild when you choose another menu-item, or
  201. whenever you press the ALT-R keycombination.
  202.  
  203. -------------------------------------------------------------------
  204.  
  205. 3. Why you should use PicList instead of other programs
  206.  
  207. OK, ofcourse I can say here that PicList is better as other
  208. programs, or has more options. I could also tell you something like
  209. "Hey, don't read this, try it", but I prefer pointing out some
  210. functions I think PicList makes more convenient to use above
  211. other, similar programs.
  212.  
  213. - PicList has a description-file (the index-file), from which it
  214.   can take descriptions for the files, there is a
  215.   wildcard-facility for series, and you can use several index-
  216.   files at the same time;
  217. - PicList can also use 4DOS-description files to get his
  218.   descriptions from;
  219. - PicList can not only search floppy disks, but also Hard-disk
  220.   drives, if desired, it can also search into subdirectories.
  221.   This is handy e.g. for tape-drives, when backing-up, you first
  222.   can catalog them using PicList;
  223. - When using floppy-drives, you can change disks without pressing
  224.   keys, i.e. if PicList wants another disk, you only have to put
  225.   it in the drive;
  226. - PicList detects a file/disk that is already cataloged, you can
  227.   choose what to do with it (catalog other disk/remove old entry
  228.   etc);
  229. - You can use your favorite viewer within PicList.
  230. - PicList has several ways to export its information (dBase and
  231.   (delimited) ASCII), so you can use PicList-information within
  232.   other programs.
  233.  
  234. -------------------------------------------------------------------
  235.  
  236. 4. How to use PicList
  237.  
  238. Hey, this should be the part most people prefer I think... Please
  239. read it carefully, there are some commands in the program that
  240. aren't pointed out in the program itself, but they are pointed out
  241. in this little manual.
  242.  
  243. Whenever you are in a menu and you press ALT-A, you get a little
  244. 'about'-screen, which gives you some information about the memory-
  245. usage of PicList. It'll display the available Conventional memory,
  246. EMS, XMS and space on the disk/directory where your TEMP-variable
  247. is set to. The TEMP-variable can be set by using the SET-command
  248. in your AUTOEXEC.BAT. If you've used TMP instead of TEMP, this
  249. will be recognized by PicList. If you haven't such a setting,
  250. PicList will display the space on the drive you're currently on.
  251.  
  252. 4.1 Configuring PicList
  253.  
  254. When you start PicList the first time you'll see the Configuration-
  255. menu. Within this menu you can edit the different settings of
  256. PicList. When you've treated PicList with programs like PKLite or
  257. Diet, it'll also start with the configuration, you can then edit
  258. the default-configuration.
  259.  
  260. The configuration is saved in the EXE-file, so please keep PicList
  261. on a disk that isn't write-protected.
  262.  
  263. If you've made changes in the configuration, you can choose to
  264. accept them, also you can save them if you want.
  265.  
  266. 4.1.1 Environment
  267.  
  268. Things you can configure that concern the environment of
  269. PicList are:
  270.  
  271. - The drive that PicList uses to search for graphical files
  272. - The directory where graphical files can be found
  273. - If PicList should scan subdirectories
  274. - How to treat double entries
  275.     -> Don't check if there are double entries
  276.     -> Ask for every double entry what to do
  277.     -> Delete other entry when you find one
  278.     -> Don't catalog the new found entry
  279. - Do you want to add descriptions whenever a picture is found that
  280.   hasn't got one
  281. - Do you want to use 4DOS-descriptions if present
  282. - Dis/enable the mouse on your system
  283. - Run in quiet mode or use sounds.
  284.  
  285. 4.1.2 Files
  286.  
  287. This is the part where you can tell PicList where to store/read
  288. it's data and indexfiles, and what names it has to use for them.
  289.  
  290. The indexfiles always have the extension .PLI, the datafiles .PLD.
  291.  
  292. When a file is NOT present, the filename will be displayed in RED,
  293. this isn't a real problem, if PicList can't find a file, a new one
  294. will be created. When you press ALT-S when you have selected the
  295. file-entering mode, you can easily select the desired data- or
  296. indexfile. The path to that file is also filled in then.
  297.  
  298. When you enter a path that isn't present, PicList can create it if
  299. you want.
  300.  
  301. The indexfile you enter is the PRIMARY indexfile, i.e. the Import-
  302. and Export-functions will use this file, and if you don't enable
  303. the Multi-indexfile option PicList will only use this file to
  304. search for descriptions.
  305.  
  306. If you enable the Multi-indexfile option, PicList will search for
  307. a description in every indexfile (.PLI-file) that is in the index-
  308. path. PICLIST WILL NOT SEARCH IN SUBDIRECTORIES.
  309.  
  310. In this screen you can also put some information about your
  311. favorite Graphics-viewer that you want to use within PicList. The
  312. most important is to put in the complete path and filename to the
  313. viewer. You can only use COM and EXE files. If you want to use
  314. the viewer with certain commandline options you can fill in them,
  315. so PicList can pass them through.
  316.  
  317. There are many viewers that return error-codes, PicList can check
  318. for them, but because most of them also use codes when you leave in
  319. a normal way, this can be annoying. That's why this option is OFF
  320. by default, if you want to use it anyway, be my guest 8*).
  321.  
  322. 4.1.3 Printer
  323.  
  324. Here you can choose where to put the info that should be printed.
  325. PicList supports up to 3 LPT-ports, and can also put the
  326. information to a file that with the command
  327.  
  328. COPY filename.ext > PRN
  329. or
  330. PRINT filename
  331.  
  332. can be printed.
  333.  
  334. If you always print the default datafile, you can enable the
  335. "Print Defaultfile", otherwise PicList will ask you which file it
  336. should print.
  337.  
  338. Also you can enter the number of lines your printer can put on one
  339. page. PicList can put a header above each page, indicating which
  340. information is showed in the columns. When you want, the pagenumber
  341. and/or date and/or time of printing can be added. The format and
  342. delimiters for the date and timestamp are from the Country-
  343. information that DOS reports. For more information about COUNTRY.SYS
  344. please read the manual for DOS (or the helpfunction if available in
  345. your version).
  346.  
  347. 4.2 Cataloging a disk
  348.  
  349. This almost the most simple thing there is; just take the bunch of
  350. diskettes you have, and put them into the drive when PicList asks
  351. for them. PicList auto-detects when a disk is removed/inserted, so
  352. you don't have to press a button any more to catalog a disk.
  353.  
  354. When you insert a disk that is already catalogged (PicList checks
  355. for diskvolumename) PicList will tell it to you, and leaves you the
  356. choice to catalog the disk and remove the other one, or to change
  357. the name of the disk you are catalogging now.
  358.  
  359. If PicList sees a duplicate file, and the Check For Double Entries
  360. is enabled in the CONFIGURATION, then PicList will also prompt you
  361. what to do. If you've chosen the item "Write New" in the
  362. configuration-menu, PicList will always overwrite the old file.
  363. Logically "Keep Old" will automaticaly skip a file that is already
  364. catalogued.
  365.  
  366. When you add descriptions on the fly, it can happen that you want
  367. to see the picture you have to describe. Use ALT-V to view that
  368. picture.
  369.  
  370. 4.3 Supported graphical formats
  371.  
  372. PicList v0.9c supports the following graphical formats:
  373.  
  374. - Graphical Interchange Format (GIF) from CompuServe, versions
  375.   87 and 89. It will give you the dimensions of the picture and
  376.   the number of POSSIBLE colors, i.e. the space that is reserved
  377.   for this. This number doesn't tell you the actual number of
  378.   colors. Also the version of the GIF-file is detected.
  379.   Extension of this format is GIF.
  380. - JFIF from the JPEG-group, all versions. The dimensions and
  381.   version are stored. The number of colors is ALWAYS 24-bit,
  382.   because I didn't find out a simple way to count these (this is a
  383.   minor disadvantage of the JFIF-format).
  384.   Extension of this format is JPG.
  385. - TrueVision TARGA (TGA), supported are compressed and uncompressed
  386.   files in Black and White, normal Color and TrueColor.
  387. - Windows 3 Bitmap (BMP) from MicroSoft, all versions. This will
  388.   give you the dimensions, number of POSSIBLE and the 'version' of
  389.   BMP-file, i.e. a RGB-uncompressed BMP, an RLE4 or 8 encoded
  390.   compressed BMP.
  391. - Windows 3 RLE (RLE) from MicroSoft, for more info see BMP-format.
  392. - ZSoft's PCX (PCX). Supported are color and grayscale pictures.
  393.   PicList gives you here as versionstring the version and the
  394.   coding algorithm (No Encoding (UNC), RLE-coded (RLE) or another,
  395.   unknown by PicList, kind of coding (COD)).
  396.  
  397. 4.4 Viewing/editing the PicList-datafile
  398.  
  399. This browser can be used with the cursor keys, the Page Up and
  400. Down, and Home/End. Ofcourse the mouse is also supported. If you
  401. want to get a quick view of available keys in this part, you can
  402. press the F1-key, and that'll give you all available commands.
  403.  
  404. When you start this item, PicList will copy the information from
  405. the primary datafile to virtual memory, this can be either EMS,
  406. XMS or a temporary file on harddisk, using the TEMP-directory. For
  407. more information about this TEMP-directory, you can read the
  408. "Using the viewer"-part (See further).
  409.  
  410. 4.4.1 Edit datafile
  411.  
  412. With this option, present under the ENTER-key or the RIGHT
  413. mousebutton, you can simply change a description that is present in
  414. the datafile. Changes won't be written directly to the datafile,
  415. when you leave the browser, and you've changed something, PicList
  416. will ask if it has to keep the new things.
  417.  
  418. If you don't want to change the description, simply press the
  419. ESC-key, and the 'old' description will be keeped.
  420.  
  421. 4.4.2 Deleting an entry
  422.  
  423. With the DEL-key you can toggle if a file has to be deleted or not.
  424. A deleted file will still be available in the browser, changes will
  425. take affect when you leave the browsing system, and confirm that
  426. you want to make the changes premanent.
  427.  
  428. A 'deleted' file can be recognized by the 'X' that stands just
  429. before the filename.
  430.  
  431. 4.4.3 Copy and Move to other datafiles
  432.  
  433. If you have certain filenames and want to copy or move them to
  434. another datafile, PicList can do that for you.
  435.  
  436. You can select the files you want to copy/move by pressing the
  437. SPACE or the LEFT mousebutton, a √ will indicate that that file is
  438. selected. Another time pressing a SPACE or the LEFT mousebutton
  439. will unselect that item.
  440.  
  441. If you have selected all the files, you just press a M or C, and
  442. the files will be moved or copied to the indexfile that you choose.
  443.  
  444. 4.4.4 Changing the current datafile
  445.  
  446. By pressing an 'O', you can simply change the current datafile for
  447. the browser. You'll see a little window in which you can go through
  448. the directory structure of your defaultdrive, starting in the
  449. directory where your primary datafile is located.
  450.  
  451. When you leave the browser after changing an datafile, PicList will
  452. restory it's primary datafile.
  453.  
  454. Empty datafiles will not be in the list of files.
  455.  
  456. 4.4.5 Information about the datafile
  457.  
  458. Whenever you press an 'I' in the browser, you'll get some
  459. information about the current datafile and memory usage.
  460.  
  461. The information about the datafile contains how many items there
  462. are in the current file, how many items you have selected, and how
  463. many items you want to delete. Also the size of the datafile on
  464. disk is displayed (the deleted items are still in it).
  465.  
  466. PicList also displays what kind of memory it's using as virtual
  467. memory, i.e. EMS, XMS or disk. Also the available amount of
  468. conventional memory, EMS, XMS and how many bytes that are free on
  469. your tempdrive are shown.
  470.  
  471. 4.4.6 Re-sort datafile on other item
  472.  
  473. Sometimes it could be handy to sort the datafile in this viewerpart
  474. not on filename, but on another item. You can do that by pressing
  475. the R when you stand in the viewer. PicList will then give you the
  476. possibilities to sort on, e.g. volume where the files are on. The
  477. filename will always be the 'second' sortcriterium, i.e. when you
  478. sort on volume, and you have several files on one volume, the files
  479. on that volume will be sorted on filename.
  480.  
  481. When you've re-sorted your datafile on another item as the filename,
  482. you won't be able to use Move or Copy.
  483.  
  484. You can re-sort your datafile as many times as you want. PicList
  485. won't save sort-changes to it's datafile, the datafiles are always
  486. sorted on filename.
  487.  
  488. 4.5 Putting out the list on printer or in a file
  489.  
  490. When you want to give a friend a copy of your picturelist, you can
  491. give him an ASCII file or a printed copy. You can make this nicely
  492. formatted with the Make Hardcopy option in the datafile menu.
  493.  
  494. In the configuration menu the ability to print can be turned on and
  495. off. Also it is possible to choose the destionation, i.e. printer
  496. or file. If you choose a file, PicList will always create an
  497. PICLIST.PRN-file in the current directory. ANY EXISTING FILE WITH
  498. THAT NAME WILL BE DELETED.
  499.  
  500. If you have disabled the "Print default datafile"-option in the
  501. configurationmenu, you'll first be prompted to select the datafile
  502. you want to be printed.
  503.  
  504. 4.6 Data Im- and Export
  505.  
  506. PicList also has the ability to put its information into other
  507. fileformats, so you can use that information within other programs.
  508. There are three formats present in the Export datafile menu.
  509.  
  510. First there is the Normal ASCII-type, this is the same file as the
  511. file created by the Print to File option, only in this option there
  512. are no printer control codes present, and there isn't a header in
  513. the file. This option can be handy for BBS-s to create the
  514. indexfiles.
  515.  
  516. Also you can export to a Delimited ASCII-file, i.e. an ASCII-file
  517. without spaces, but with an comma between the entries. Syntax is
  518. something like "FILENAME.EXT","VOLUME","..." etc.
  519.  
  520. If you want to use PicList datafiles in most databases or spread-
  521. sheet programs, you can benefit from the dBase-format. The format
  522. provided here is the most used one, namely dBase III(+)/IV.
  523.  
  524. The same formats can be used to import data to your current PicList
  525. datafile. This way you can create several datafiles (e.g. Tape#1,
  526. Tape#2, etc. and one master catalog, in which all files are
  527. imported).
  528.  
  529. 4.7 Viewing/editing the PicList-indexfile
  530.  
  531. This browser can be used in the same way as the datafile-browser,
  532. with the cursor keys, the Page Up and Down, and Home/End. Ofcourse
  533. the mouse is also supported. If you want to get a quick view of
  534. available keys in this part, you can press the F1-key, and that'll
  535. give you all available commands.
  536.  
  537. When you start this item, PicList will copy the information from
  538. the primary indexfile to virtual memory, this can be either EMS,
  539. XMS or a temporary file on harddisk, using the TEMP-directory. For
  540. more information about this TEMP-directory, you can read the
  541. "Using the viewer"-part (See further).
  542.  
  543. 4.7.1 Edit indexfile
  544.  
  545. With this option, present under the ENTER-key or the RIGHT
  546. mousebutton, you can simply change a description that is present in
  547. the indexfile. Changes won't be written directly to the indexfile,
  548. when you leave the browser, and you've changed something, PicList
  549. will ask if it has to keep the new things.
  550.  
  551. If you don't want to change the description, simply press the
  552. ESC-key, and the 'old' description will be keeped.
  553.  
  554. 4.7.2 Add to indexfile
  555.  
  556. Pressing the INS-key will give you the ability to create a new
  557. indexitem. You are prompted to give the filename and description,
  558. and PicList will add this item to the current indexfile. If you
  559. enter a description that is already present, PicList will not
  560. keep it.
  561.  
  562. If you want to create a wildcarddescription, please note this
  563. 'rules':
  564.  
  565. -> Only wildcard that is allowed is the ?-sign
  566. -> There may be a maximum of 1 questionmark in a description
  567. -> Only numbers can be wildcards
  568. -> Don't give the extension with the filename
  569. -> A maximum of 100 new items can be added. When you exceed this
  570.    number, just leave the browser (ofcourse save the new file),
  571.    and enter the browser again. This is because PicList only
  572.    reserves 100 extra places in its virtual memory for new files.
  573.  
  574. If you have e.g. a series with as format XXXX-00 to XXXX-99, you
  575. can get this to wildcard as "XXXX-?". With this wildcard also
  576. a file "XXXX-1" and "XXXX-309" are supported.
  577.  
  578. 4.7.3 Deleting a description
  579.  
  580. With the DEL-key you can toggle if a file has to be deleted or not.
  581. A deleted file will still be available in the browser, changes will
  582. take affect when you leave the browsing system, and confirm that
  583. you want to make the changes premanent.
  584.  
  585. A 'deleted' file can be recognized by the 'X' that stands just
  586. before the filename.
  587.  
  588. 4.7.4 Copy and Move to other indexfiles
  589.  
  590. If you have certain filenames and want to copy or move them to
  591. another indexfile, PicList can do that for you.
  592.  
  593. You can select the files you want to copy/move by pressing the
  594. SPACE or the LEFT mousebutton, a √ will indicate that that file is
  595. selected. Another time pressing a SPACE or the LEFT mousebutton
  596. will unselect that item.
  597.  
  598. If you have selected all the files, you just press a M or C, and
  599. the files will be moved or copied to the indexfile that you choose.
  600.  
  601. 4.7.5 Changing the current indexfile
  602.  
  603. By pressing an 'O', you can simply change the current indexfile for
  604. the browser. You'll see a little window in which you can go through
  605. the directory structure of your defaultdrive, starting in the
  606. directory where your primary indexfile is located.
  607.  
  608. When you leave the browser after changing an indexfile, PicList
  609. will restory it's primary indexfile.
  610.  
  611. Empty indexfiles will not be in the list of files.
  612.  
  613. 4.7.6 Information about the indexfile
  614.  
  615. Whenever you press an 'I' in the browser, you'll get some
  616. information about the current indexfile and memory usage.
  617.  
  618. The information about the indexfile contains how many descriptions
  619. there are in the current file, how many items you have selected,
  620. and how many items you want to delete. Also the size of the
  621. indexfile on disk is displayed (the deleted items are still in it).
  622.  
  623. PicList also displays what kind of memory it's using as virtual
  624. memory, i.e. EMS, XMS or disk. Also the available amount of
  625. conventional memory, EMS, XMS and how many bytes that are free on
  626. your tempdrive are shown.
  627.  
  628. 4.7.7 Create wildcards
  629.  
  630. If you find several files in your indexfile that could be taken
  631. together with a wildcard, you can use PicList to create that
  632. wildcard for you. If you have one file that should be changed into
  633. a wildcard filename, it can be done too.
  634.  
  635. You simply select the file(s) you want to use, and PicList will
  636. create the wildcard filename including the description. The first
  637. filename will be changed into the wildcardname, the others will be
  638. deleted.
  639.  
  640. If you select several files, please note that the files must have the
  641. same description. Only numbers can be wildcarded, and the wildcard-
  642. character '?' may not be the first character in the filename.
  643.  
  644. 4.7.8 Re-sort indexfile on other item
  645.  
  646. Sometimes it could be handy to sort the indexfile in this viewerpart
  647. not on filename, but on description. You can do that by pressing
  648. the R when you stand in the viewer. PicList will then ask you if you
  649. want to re-sort the indexfile on description. Another time pressing
  650. the R will cause PicList to re-sort on filename again.
  651.  
  652. When you've re-sorted your indexfile on description, you won't be able
  653. to use Move, Copy, Create Wildcard or New Description.
  654.  
  655. PicList will always keep it's indexfile sorted after filename instead
  656. of description. You can re-sort your indexfile as many time as you
  657. want.
  658.  
  659. 4.8 Index Im- and Export
  660.  
  661. PicList uses an indexfile to get the descriptions for the pictures
  662. you catalog. The indexfile can be created by yourself with the help
  663. of the description-management menu of PicList like said in the
  664. previous paragraph.
  665.  
  666. In the indexmenu it's also possible to recheck your PicList-
  667. datafile. This is handy when you have added several descriptions,
  668. and you want to 'upgrade' your datafile.
  669.  
  670. Also it is possible to get all the descriptions that don't appear
  671. in your indexfile from the datafile. This is handy when you have
  672. new descriptions.
  673.  
  674. The description-file can also be upgraded with the help of an
  675. ASCII-file (syntax : FILENAME|Description; so | is the delimiter).
  676. When you want to look what stands in the description-file, the
  677. exportfunction in the index Management-menu will create a
  678. ASCII-dumpfile of the indexfile.
  679.  
  680. You can also export and import from standard dBase III/IV-files.
  681.  
  682. If an DESCRIPT.ION file (4DOS or NDOS-descriptions) is present,
  683. and the 'Use 4DOS descriptions'-option in the configuration menu is
  684. enabled, then PicList will first look if there is an entry for the
  685. file in the DESCRIPT.ION-file. If present PicList will use this
  686. description, and will not look in the .IDX-file. This will only
  687. take place when your pictures are being catalogged, if you upgrade
  688. your datafile PicList won't look for 4DOS-files.
  689.  
  690. PicList can use several indexfiles at the same time (see
  691. Configuration - Files). A big advantage of this is that you can
  692. create indexfiles for every kind of picture you have, e.g.
  693. "planes.idx", "buildings.idx", "cartoons.idx" etc.
  694.  
  695. 4.9 Using the viewer
  696.  
  697. Because you can use a viewer you like, I can't tell you how to use
  698. the viewer to defined, but only some aspects of using it within
  699. PicList. You can use the viewer from the main menu, PicList will
  700. then pass his path where he has to look for graphical files to that
  701. viewer. When starting it, PicList will swap itself almost totally
  702. into EMS or to a file on your disk (There will only be about
  703. 1.5 k's that will be occupied by the program). The file will be
  704. written into your TEMP-dir (you can set this by using the command
  705. SET TEMP=C:\DirectoryYouWantToUse). If you've name this setting
  706. TMP instead of TEMP PicList will recognize it also.
  707.  
  708. When your computer crashes when using the viewer and you were
  709. swapping to disk, most of the times the temporary file will stay on
  710. your disk. You can safely delete it then; the file hasn't got a
  711. real name, just a 'strange' combination of characters.
  712.  
  713. -------------------------------------------------------------------
  714.  
  715. 5. Known bugs
  716.  
  717. "Your program always contains one more unknown bug" - Murphy's Law
  718.  
  719. Before PicList is released, it is tested by several people. Every
  720. bug that I discover, I try to work out, but it is ofcourse very
  721. well possible that on other systems there are other things that
  722. don't work the way they should, or that a bug just didn't occur
  723. because a function wasn't used. Below is a summary of things that
  724. could cause problems, and that can't easily be solved, so I just
  725. left them in because they won't occur at normal use.
  726.  
  727. All systems:
  728.  
  729. - When a screensaver became active, the screen is almost always
  730.   messed up; this will NOT affect the normal working of PicList,
  731.   and the program cleans it up whenever you enter a new menu. If
  732.   you want to restore the screen just press ALT-R, and in most
  733.   cases it will be restored.
  734. - Lots of bugs in this DOC-file, I know, my English should be
  735.   better...
  736.  
  737. Maybe on some systems:
  738.  
  739. - It is possible that the auto-disk-in-drive detection, or the
  740.   diskchange-detection doesn't work on some older systems. (on all
  741.   new systems it should work fine), when you find this error on
  742.   systems that are not too old (i.e. 386 or better), please
  743.   contact me. It is possible on some 286 systems that it won't
  744.   work.
  745.  
  746. Because I'm still working on this program, please contact me with
  747. any problems you find, and I'll try to solve them in future
  748. releases.
  749.  
  750. -------------------------------------------------------------------
  751.  
  752. 6. What can be expected in the future (What to do)
  753.  
  754. There are lots of ideas that can be used for the future, but don't
  755. hesitate to give me some hints about things you want in PicList
  756. v???. Don't look strange if a new version doesn't cover next
  757. things, these are only ideas of stuff to do...
  758.  
  759. - Ofcourse, more formats, there are so much formats used in
  760.   compuland that PicList will never cover all the formats. If you
  761.   have certain formats that you think PicList should be able to
  762.   work with, please contact me;
  763. - Improve this file... There should be more info in it.
  764.  
  765. Lots of work to do, but again, please let me know your hints for a
  766. new version of PicList, it can be usefull to other people too.
  767.  
  768. -------------------------------------------------------------------
  769.  
  770. 7. How to contact the writer
  771.  
  772. If you want to contact me for questions/comments on this program,
  773. you can E-mail me (at least until October 1995) :
  774. ericg@stack.urc.tue.nl. I always try to give quick answers, but
  775. it's sometimes not possible due to holidays etc.
  776.  
  777. -------------------------------------------------------------------
  778.  
  779. <END OF FILE> PICLIST.DOC for PicList v0.9c
  780.